Node / meshtastic / Meshtastic-Android / files / docs / ht-rHT / user / debug-logs.md

Displaying Raw • View rendered • Download

---

title: Debug Logs

parent: User Guide

nav_order: 22

last_updated: 2026-08-30

description: View and export the app's own debug logs from inside the app, and attach a capture to a GitHub issue to help diagnose bugs — no adb required.

aliases:

Tff7b72- debug-logs

Tff7b72- logcat

Tff7b72- app-logs

Tc9d1d9 - bug-report

Tc9d1d9---

Tc9d1d9# Debug Logs

When something misbehaves, the app's debug logs are the single most useful thing you can attach to a bug report. Meshtastic can capture them **for you, from inside the app** — you don't need Ta5d6ff`adb` or any desktop tooling to collect them.

Open the **Debug Panel** from **Settings → Advanced → Debug Panel**.

If you're filing an issue, export your logs (see [Tff7b72Exporting](Te6edf3#exporting)) and attach the Ta5d6ff`.txt` file to your report on the [Tff7b72Meshtastic-Android issue tracker](Te6edf3https://github.com/meshtastic/Meshtastic-Android/issues). A log capture that covers the moment the problem happened turns "it doesn't work" into something a developer can actually track down.

Tc9d1d9## The two tabs

The Debug Panel has two tabs:

Tff7b72- **Packets** — the decoded mesh traffic your radio has sent and received (protocol-level messages). Useful for diagnosing mesh and routing behavior.

Tff7b72- **App logs** — the app's own diagnostic log (Android _logcat_), including warnings, errors, and stack traces from the app itself. This is usually what a bug report needs.

Each tab has its own **export** button and produces its own file, so you can grab whichever is relevant — or both.

Tc9d1d9## Viewing app logs

The **App logs** tab shows the most recent log lines from **this app only** — never other apps on your phone.

Tff7b72- **Search** — type in the search box to filter to matching lines.

Tff7b72- **Level filter** — the **V / D / I / W / E** chips toggle Verbose, Debug, Info, Warn, and Error lines. Tap a level to hide it; tap again to bring it back. Fatal lines are always shown.

Tff7b72- **Refresh** — the refresh icon re-reads the latest logs.

Error and warning lines are tinted so problems stand out.

Tc9d1d9## Exporting

Tap the **download** icon to save the current logs to a file. The app first shows a warning about what the file contains — confirm it, then choose where the file goes through the system file picker. The file is named with a timestamp (for example Ta5d6ff`meshtastic_logcat_20260701_143312.txt`) so repeated exports never overwrite each other. The same warning guards the **Packets** tab export.

Attach that file to your GitHub issue.

Tff7b72> 🔒 **Privacy:** Exports automatically **redact** private keys, admin keys, session passkeys, and channel PSKs, and suppress raw packet bytes. Everything else stays — the file can contain your message text, precise locations, and node details. Read it before sharing it publicly, and share privately if you have any doubt.

Tc9d1d9## Desktop

The desktop app has no system logcat, so the **App logs** tab shows the app's own captured log output instead. Search, filtering, and export work the same way.

Tc9d1d9## Related Topics

Tff7b72- [Tff7b72Help & In-App Docs](Te6edf3help-and-docs) — reading this documentation offline inside the app

Tff7b72- [Tff7b72Connections](Te6edf3connections) — if the problem is getting connected to your radio in the first place